schm-mdm-eapi

(0 reviews)

schm-mdm-eapi 中文文档

接口描述: 通过Mulesoft接口获取MDM数据,如:主数据,配额数据等。
DEV地址(开发环境): https://schm-api-dev.shiseido.cn/schm-mdm-eapi
UAT地址(测试环境): https://schm-api-test.shiseido.cn/schm-mdm-eapi
PROD地址(生产环境): https://schm-api.shiseido.cn/schm-mdm-eapi

1.身份认证

所有请求头必须包含以下键值参数作为身份验证信息。您需要向管理员申请这些信息。

client_id: fa98****3452
client_secret: 108b****41f2

2.接口总览:

请求接口描述
/master/customer获取Customer主数据
/master/product获取Product主数据
/master/hygienePermit获取HygienePermit主数据
/master/vendor获取Vendor主数据
/master/quota获取配额管理主数据
/master/quotaCalculate获取配额计算主数据
/master/stockOnHandPlant获取工厂级在库库存主数据
/master/productPrice获取产品单价主数据
/master/inboundDelivery获取SAP入库指示主数据
/master/materialSuitMain获取店铺虚拟套装等其他物料主数据
/master/materialSuitSub获取店铺虚拟套装明细主数据
/master/businessCustomer获取客户主数据(fro业务)主数据
/master/cusEmployeeMapping店铺人员人店关系主数据
/master/empstruct总部人员销售角色主数据
/master/structMaster品牌地区架构主数据
/master/materialSuitInfo实物组套主件子件关系
/master/subUnit办事处主表
/master/brand主数据:现地品牌
/master/localbeamtd1主数据:现地美容法1
/master/localbeamtd2主数据:现地美容法2
/master/localbeamtd3主数据:现地美容法3
/master/custSubCategory主数据:自定义分类子类别
/master/custSubLineCategory主数据:产品自定义分类关系表

完整调用地址为对应环境地址+接口地址,如测试环境获取Customer主数据接口调用地址为:
https://schm-api-test.shiseido.cn/schm-mdm-eapi/master/customer

3.接口调用说明

3.1 获取Customer主数据

请求接口: /master/customer
接口描述: 用于获取Customer主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN主数据最后更新时间,接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/customer?pageSize=20&pageNo=10&updateTime=2024-05-01

返回参数

字段类型长度字段描述数据举例
COMPANYCDchar3所属公司代码785
JYFLGchar1解约标记0
SAP_CUSTOMERCDchar10ShipTo代码2200004137
CUSTOMERNMchar80ShipTo名称LM天猫官方旗舰店(新)
LOCATIONchar80ShipTo地址上海市金山区天工路285弄恒信科技产业园28号口
SIDECDchar3省代码003
SAP_REGIONNMchar40上海市
AREACDchar3城市代码076
AREANMchar40城市null
POSTCDchar10ShipTo邮编310051
TELNOchar30ShipTo电话189000000
FAXNOchar30ShipTo传真
NAME_COchar80C/O contract person
CustomerGroup1char3POS区分207
PODFLGchar1POD 标识1
PODCONFIRMTIMEchar11自动确认POD的时间戳720000
FSS_LOCATIONIDdatetimeFSS Sloc number785BW001
UPDATETIMEchar60更新时间2024-06-04T23
CUSTOMERCDchar10周边店铺代码2200004137
SalesCompanychar3销售公司9Z2

接口返回值示例

[
    {
        "COMPANYCD": "785",
        "DELFLG": "0",
        "CUSTOMERCD": "2200004137",
        "SHOPSIGNNM": "LM天猫官方旗舰店(新)",
        "SHOPADR": "上海市金山区天工路285弄恒信科技产业园28号口",
        "SIDECD": "003",
        "SIDENM": "上海市",
        "AREACD": "076",
        "AREANM": null,
        "SHOPPOSTCD": "310051",
        "SHOPTEL": "18916792980",
        "SHOPFAX": null,
        "NAME_CO": null,
        "CustomerGroup1": "207",
        "PODFLG": "1",
        "PODCONFIRMTIME": "720000",
        "FSS_LOCATIONID": "785BW001",
        "UPDATETIME": "2024-06-04T23:00:37.08",
        "OldCUSTOMERCD": "2200004137"
    },
    {
        "COMPANYCD": "785",
        "DELFLG": "0",
        "CUSTOMERCD": "2200004137",
        "SHOPSIGNNM": "LM天猫官方旗舰店(新)",
        "SHOPADR": "上海市金山区天工路285弄恒信科技产业园28号口",
        "SIDECD": "003",
        "SIDENM": "上海市",
        "AREACD": "076",
        "AREANM": null,
        "SHOPPOSTCD": "310051",
        "SHOPTEL": "18916792980",
        "SHOPFAX": null,
        "NAME_CO": null,
        "CustomerGroup1": null,
        "PODFLG": "1",
        "PODCONFIRMTIME": "720000",
        "FSS_LOCATIONID": "785BW001",
        "UPDATETIME": "2024-06-04T23:00:37.047",
        "OldCUSTOMERCD": "2200004137"
    },
    {
        "COMPANYCD": "785",
        "DELFLG": "0",
        "CUSTOMERCD": "2200003705",
        "SHOPSIGNNM": "NARS上海久光中心",
        "SHOPADR": "上海市静安区共和新路2188号大宁久光中心1楼M102号铺NARS专柜",
        "SIDECD": "003",
        "SIDENM": "上海市",
        "AREACD": "076",
        "AREANM": null,
        "SHOPPOSTCD": "200040",
        "SHOPTEL": null,
        "SHOPFAX": null,
        "NAME_CO": null,
        "CustomerGroup1": "202",
        "PODFLG": "1",
        "PODCONFIRMTIME": "0",
        "FSS_LOCATIONID": null,
        "UPDATETIME": "2024-06-03T23:00:34.547",
        "OldCUSTOMERCD": "10700057"
    }
]

3.2 获取Product主数据

请求接口: /master/product
接口描述: 用于获取Product主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
MDMUPDATETIMEN接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00
SAPPRODUCTCDN可按SAP产品代码查询,多个SAP产品代码用“,”分割
BRANDN可按品牌代码查询,多个品牌代码用“,”分割
InvalidFLGN可按11D 无效标识查询

接口请求示例:
/master/product?pageSize=20&pageNo=10&MDMUPDATETIME=2024-05-01&SAPPRODUCTCD=10111379301,10111379302

返回参数

字段类型长度字段描述数据举例
COMPANYCDCHAR3所属公司代码
SAPPRODUCTCDCHAR18SAP产品代码
PRODUCTCDCHAR8产品代码
PRODCHINMCHAR100产品中文名称
PRODENGNMCHAR100产品英文名称
PRODFLGCHAR2产品区分标志
PRODFLGNMCHAR20产品区分名称
BRANDchar2品牌代码
BRANDNMCHAR80产品层次名称
LINECHAR4LINE
LINENMCHAR80新品牌名称
SUBLINECHAR4SUBLINE
SUBLINENMCHAR80新产品系列名称
MDMUPDATETIMEDATETIMEMDM更新时间
PRODBARCODE1CHAR18产品条码
MAILINNOINT包装规格
LengthNVARCHAR13长度
WidthNVARCHAR13宽度
HeightNVARCHAR13高度
BusinessVolumeNVARCHAR13体积
PK_MAILINNOINT中包装规格
PK_LengthNVARCHAR13中包装长度
PK_WidthNVARCHAR13中包装宽度
PK_HeightNVARCHAR13中包装高度
PK_BusinessVolumeNVARCHAR13中包装体积
MAILINNOBIGINT大包装规格
KAR_LengthNVARCHAR13大包装长度
KAR_WidthNVARCHAR13大包装宽度
KAR_HeightNVARCHAR13大包装高度
KAR_BusinessVolumeNVARCHAR13大包装体积
MEINSCHAR3基本计量单位
PRODUCTAVAILINTGlobal shelf life
LifeDateFlagCHAR1期间标识
LocalPRODUCTAVAILINTLocal shelf life
BATCHFLGCHAR1批次管理标志
NetContentfloat净含量
NetContentUnitsCHAR3净含量单位
ReferenceFLGchar1一物一码标识
InvalidFLGCHAR111D 无效标识
SALETYPE1CHAR3Sales type1
SALETYPE1NMCHAR80Sales type1名称
SALETYPE2CHAR4Sales type2
SALETYPE2NMCHAR80Sales type2名称
SALETYPE3CHAR6Sales Type 3
SALETYPE3NMCHAR80Sales Type 3名称
DETERMINECODECHAR13物料确定号
STARTYMDDATETIME销售开始日期
RPRICEMNYMONEY零售单价
NoUseFlgCHAR1周边物料建议停止使用标记
ORDERSTOPTIMEDATETIME发注终止日
RelabelFLGCHAR1贴标标识
MaterialTypeCHAR4物料类型
ENDYMDDATETIME销售停止日
LOCALBEAMTDCD1CHAR1现地美容法1代码
LOCALBEAMTDCD1NMCHAR80现地美容法1名
LOCALBEAMTDCD2CHAR2现地美容法2代码
LOCALBEAMTDCD2NMCHAR80现地美容法2名
LOCALBEAMTDCD3CHAR3现地美容法3代码
LOCALBEAMTDCD3NMCHAR80现地美容法3名
LOCALBRANDCDCHAR4现地品牌代码
LOCALBRANDNMCHAR20现地品牌名
PRODUCTHIERARCHYLV4CHAR2新美容法1
PRODUCTHIERARCHYLV4NMCHAR80新美容法1名
PRODUCTHIERARCHYLV45CHAR4新美容法2
PRODUCTHIERARCHYLV45NMCHAR80新美容法2名
PRODUCTHIERARCHYLV456CHAR6新美容法3
PRODUCTHIERARCHYLV456NMCHAR80新美容法3名
PRODINFLGCHAR1区域标志
DELFLGCHAR1删除标志
OrderENDYMDDATETIME订货停止日
DETERMINEFLGCHAR1物料确定标识
MSTAECHAR27857物料状态
associate_Z001varchar13关联Z001物料确定号
POSM_AUTO_FLGCHAR1POSM计算FLG0-自动计算价值;1-手动计算价值;2-下架产品;3-无需价值;9-暂时不自动计算
POSMValuemoney1POSM价值

接口返回值示例

[
    {
        "COMPANYCD": "785",
        "SAPPRODUCTCD": "10113681802CN",
        "PRODUCTCD": "13681",
        "PRODCHINM": "吾诺保湿调理乳(滋润型)",
        "PRODENGNM": "VGB.UNOSKINCARETANKMOIST",
        "PRODFLG": "01",
        "PRODFLGNM": "成品",
        "BRAND": "5A",
        "BRANDNM": "UNO",
        "LINE": "5AHE",
        "LINENM": "UNOPERSONALCARE",
        "SUBLINE": "5AHE10",
        "SUBLINENM": "UNOPERSONALCARE",
        "MDMUPDATETIME": "2023-12-05T07:35:23.183",
        "PRODBARCODE1": "4909978136819",
        "MAILINNO": 0,
        "Length": "0.000",
        "Width": "0.000",
        "Height": "0.000",
        "BusinessVolume": "0.000",
        "PK_MAILINNO": 36,
        "PK_Length": "25.000",
        "PK_Width": "54.000",
        "PK_Height": "16.500",
        "PK_BusinessVolume": "22275.000",
        "MAILINNOBIG": null,
        "KAR_Length": null,
        "KAR_Width": null,
        "KAR_Height": null,
        "KAR_BusinessVolume": null,
        "MEINS": "EA",
        "PRODUCTAVAIL": 1,
        "LifeDateFlag": "D",
        "LocalPRODUCTAVAIL": 1095,
        "BATCHFLG": "1",
        "NetContent": 160,
        "NetContentUnits": "ML",
        "ReferenceFLG": "0",
        "InvalidFLG": "0",
        "SALETYPE1": "10",
        "SALETYPE1NM": "SALEABLEPRODUCT",
        "SALETYPE2": "1010",
        "SALETYPE2NM": "Basic",
        "SALETYPE3": "101010",
        "SALETYPE3NM": "Single-basic",
        "DETERMINECODE": "10113681803CN",
        "STARTYMD": "2019-02-01T00:00:00",
        "RPRICEMNY": 78,
        "NoUseFlg": null,
        "ORDERSTOPTIME": "2023-01-01T00:00:00",
        "RelabelFLG": "0",
        "MaterialType": "Z001",
        "ENDYMD": null,
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD1NM": "护肤",
        "LOCALBEAMTDCD2": "NN",
        "LOCALBEAMTDCD2NM": "无",
        "LOCALBEAMTDCD3": "008",
        "LOCALBEAMTDCD3NM": "护肤-乳液",
        "LOCALBRANDCD": "7001",
        "LOCALBRANDNM": "FT",
        "PRODUCTHIERARCHYLV4": "C1",
        "PRODUCTHIERARCHYLV4NM": null,
        "PRODUCTHIERARCHYLV45": "C130",
        "PRODUCTHIERARCHYLV45NM": null,
        "PRODUCTHIERARCHYLV456": "C13020",
        "PRODUCTHIERARCHYLV456NM": null,
        "PRODINFLG": "0",
        "DELFLG": "0",
        "OrderENDYMD": null,
        "DETERMINEFLG": "0",
        "MSTAE": "4H",
        "associate_Z001": "10122444801CN",
        "POSM_AUTO_FLG": "9",
        "POSMValue": null
    },
    {
        "COMPANYCD": "785",
        "SAPPRODUCTCD": "10113685801CN",
        "PRODUCTCD": "13685",
        "PRODCHINM": "吾诺保湿调理乳(清爽型)",
        "PRODENGNM": "VGA.UNOSKINCARETANKOILCONTROL",
        "PRODFLG": "01",
        "PRODFLGNM": "成品",
        "BRAND": "5A",
        "BRANDNM": "UNO",
        "LINE": "5AHE",
        "LINENM": "UNOPERSONALCARE",
        "SUBLINE": "5AHE10",
        "SUBLINENM": "UNOPERSONALCARE",
        "MDMUPDATETIME": "2023-12-05T07:35:23.183",
        "PRODBARCODE1": "4909978136857",
        "MAILINNO": 0,
        "Length": "0.000",
        "Width": "0.000",
        "Height": "0.000",
        "BusinessVolume": "0.000",
        "PK_MAILINNO": 36,
        "PK_Length": "25.000",
        "PK_Width": "54.000",
        "PK_Height": "16.500",
        "PK_BusinessVolume": "22275.000",
        "MAILINNOBIG": null,
        "KAR_Length": null,
        "KAR_Width": null,
        "KAR_Height": null,
        "KAR_BusinessVolume": null,
        "MEINS": "EA",
        "PRODUCTAVAIL": 1,
        "LifeDateFlag": "D",
        "LocalPRODUCTAVAIL": 1095,
        "BATCHFLG": "1",
        "NetContent": 160,
        "NetContentUnits": "ML",
        "ReferenceFLG": "1",
        "InvalidFLG": "0",
        "SALETYPE1": "10",
        "SALETYPE1NM": "SALEABLEPRODUCT",
        "SALETYPE2": "1010",
        "SALETYPE2NM": "Basic",
        "SALETYPE3": "101010",
        "SALETYPE3NM": "Single-basic",
        "DETERMINECODE": "10113685803CN",
        "STARTYMD": "2019-02-01T00:00:00",
        "RPRICEMNY": 78,
        "NoUseFlg": null,
        "ORDERSTOPTIME": "2023-01-01T00:00:00",
        "RelabelFLG": "0",
        "MaterialType": "Z001",
        "ENDYMD": null,
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD1NM": "护肤",
        "LOCALBEAMTDCD2": "NN",
        "LOCALBEAMTDCD2NM": "无",
        "LOCALBEAMTDCD3": "008",
        "LOCALBEAMTDCD3NM": "护肤-乳液",
        "LOCALBRANDCD": "7001",
        "LOCALBRANDNM": "FT",
        "PRODUCTHIERARCHYLV4": "C1",
        "PRODUCTHIERARCHYLV4NM": null,
        "PRODUCTHIERARCHYLV45": "C130",
        "PRODUCTHIERARCHYLV45NM": null,
        "PRODUCTHIERARCHYLV456": "C13020",
        "PRODUCTHIERARCHYLV456NM": null,
        "PRODINFLG": "0",
        "DELFLG": "0",
        "OrderENDYMD": null,
        "DETERMINEFLG": "0",
        "MSTAE": "4H",
        "associate_Z001": "10122444801CN",
        "POSM_AUTO_FLG": "9",
        "POSMValue": null
    },
    {
        "COMPANYCD": "785",
        "SAPPRODUCTCD": "10113685802CN",
        "PRODUCTCD": "13685",
        "PRODCHINM": "吾诺保湿调理乳(清爽型)",
        "PRODENGNM": "VGB.UNOSKINCARETANKOILCONTROL",
        "PRODFLG": "01",
        "PRODFLGNM": "成品",
        "BRAND": "5A",
        "BRANDNM": "UNO",
        "LINE": "5AHE",
        "LINENM": "UNOPERSONALCARE",
        "SUBLINE": "5AHE10",
        "SUBLINENM": "UNOPERSONALCARE",
        "MDMUPDATETIME": "2023-12-05T07:35:23.183",
        "PRODBARCODE1": "4901872449729",
        "MAILINNO": 0,
        "Length": "0.000",
        "Width": "0.000",
        "Height": "0.000",
        "BusinessVolume": "0.000",
        "PK_MAILINNO": 36,
        "PK_Length": "25.000",
        "PK_Width": "54.000",
        "PK_Height": "16.500",
        "PK_BusinessVolume": "22275.000",
        "MAILINNOBIG": null,
        "KAR_Length": null,
        "KAR_Width": null,
        "KAR_Height": null,
        "KAR_BusinessVolume": null,
        "MEINS": "EA",
        "PRODUCTAVAIL": 1,
        "LifeDateFlag": "D",
        "LocalPRODUCTAVAIL": 1095,
        "BATCHFLG": "1",
        "NetContent": 160,
        "NetContentUnits": "ML",
        "ReferenceFLG": "0",
        "InvalidFLG": "0",
        "SALETYPE1": "10",
        "SALETYPE1NM": "SALEABLEPRODUCT",
        "SALETYPE2": "1010",
        "SALETYPE2NM": "Basic",
        "SALETYPE3": "101010",
        "SALETYPE3NM": "Single-basic",
        "DETERMINECODE": "10113685803CN",
        "STARTYMD": "2019-02-01T00:00:00",
        "RPRICEMNY": 78,
        "NoUseFlg": null,
        "ORDERSTOPTIME": "2023-01-01T00:00:00",
        "RelabelFLG": "0",
        "MaterialType": "Z001",
        "ENDYMD": null,
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD1NM": "护肤",
        "LOCALBEAMTDCD2": "NN",
        "LOCALBEAMTDCD2NM": "无",
        "LOCALBEAMTDCD3": "008",
        "LOCALBEAMTDCD3NM": "护肤-乳液",
        "LOCALBRANDCD": "7001",
        "LOCALBRANDNM": "FT",
        "PRODUCTHIERARCHYLV4": "C1",
        "PRODUCTHIERARCHYLV4NM": null,
        "PRODUCTHIERARCHYLV45": "C130",
        "PRODUCTHIERARCHYLV45NM": null,
        "PRODUCTHIERARCHYLV456": "C13020",
        "PRODUCTHIERARCHYLV456NM": null,
        "PRODINFLG": "0",
        "DELFLG": "0",
        "OrderENDYMD": null,
        "DETERMINEFLG": "0",
        "MSTAE": "4H",
        "associate_Z001": "10122444801CN",
        "POSM_AUTO_FLG": "9",
        "POSMValue": null
    }
]

3.3 获取HygienePermit主数据

请求接口: /master/hygienePermit
接口描述: 用于获取HygienePermit主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN主数据最后更新时间,接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00。注意,这个时间并非到期时间(HygienePermitExpiryDate)

接口请求示例:
/master/hygienePermit?pageSize=20&pageNo=10&updateTime=2024-05-01

返回参数

字段类型长度字段描述数据举例
SAPPRODUCTCDnvarchar13产品代码10100047000
HygienePermitNumbernvarchar40HP信息国妆特进字J20191876
HygienePermitExpiryDatedatetime到期时间2027-10-30 00:00:00.000
UPDATETIMEdatetime更新时间

接口返回值示例

[
  {
    "SAPPRODUCTCD": "10113448801",
    "HygienePermitNumber": "国妆网备进字(沪)2020006339",
    "HygienePermitExpiryDate": "2099-12-31T00:00:00",
    "PRODCHINM": "怡丽丝尔 肌源焕活 弹力凝粹乳",
    "UPDATETIME": "2024-02-01T16:18:38"
  },
  {
    "SAPPRODUCTCD": "10118081102",
    "HygienePermitNumber": "国妆网备进字(沪)2020010034",
    "HygienePermitExpiryDate": "2099-12-31T00:00:00",
    "PRODCHINM": "御银座 柔澈洁颜油 P",
    "UPDATETIME": "2024-02-01T16:18:38"
  },
  {
    "SAPPRODUCTCD": "10118178803",
    "HygienePermitNumber": null,
    "HygienePermitExpiryDate": null,
    "PRODCHINM": "CPB-肌肤之钥 光透白焕采妆前乳",
    "UPDATETIME": "2024-02-01T16:18:38"
  }
]

3.4 获取Vendor主数据

请求接口: /master/vendor
接口描述: 用于获取Vendor主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN主数据最后更新时间(DataYmd),接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/vendor?pageSize=20&pageNo=10&updateTime=2024-05-01

返回参数

字段类型长度字段描述数据举例
VendorCodeCHAR10供应商3100001411
AccountGroupCHAR4帐户组Z001
CountryCHAR3国家CN
Name1CHAR70名称1Bean Media Group Pty Ltd
Name2CHAR70名称2
CityCHAR70城市上海市
PostalCodeCHAR10邮政编码210000
RegionCHAR3地区020
StreetCHAR70街道黄浦区淮海中路1号柳林大厦26层
TelephoneCHAR30电话69504873
FaxCHAR31传真69504873
CompanyCodeCHAR3公司代码785
PurchasingOrganizationCHAR4采购组织2001
DataYmdCHAR8更新时间20220520

接口返回值示例

[
    {
        "VendorCode": "0A78200001",
        "AccountGroup": "Z007",
        "Country": "US",
        "Name1": "ADC PLANT",
        "Name2": null,
        "City": "Groveport",
        "PostalCode": "43125",
        "Region": "OH",
        "Street": "5271 Centerpoint Pkwy",
        "Telephone": null,
        "Fax": null,
        "CompanyCode": "785",
        "PurchasingOrganization": "2001",
        "DataYmd": "2024-06-03T23:00:42.967"
    },
    {
        "VendorCode": "0A78200000",
        "AccountGroup": "Z007",
        "Country": "US",
        "Name1": "Shiseido Americas Corporation",
        "Name2": null,
        "City": "New York",
        "PostalCode": "10017",
        "Region": null,
        "Street": "390 Madison Avenue, 19F",
        "Telephone": "1-212-805-2300",
        "Fax": null,
        "CompanyCode": "785",
        "PurchasingOrganization": "2001",
        "DataYmd": "2024-06-02T23:00:52.503"
    },
    {
        "VendorCode": "0A10000010",
        "AccountGroup": "Z007",
        "Country": "JP",
        "Name1": "SHISEIDO CO JDC East.",
        "Name2": null,
        "City": "Iruma",
        "PostalCode": "3540045",
        "Region": "11",
        "Street": "Miyoshi, Kamitome, 247",
        "Telephone": null,
        "Fax": null,
        "CompanyCode": "785",
        "PurchasingOrganization": "2001",
        "DataYmd": "2024-05-27T11:46:19.31"
    }
]

3.5 获取配额管理主数据

请求接口: /master/quota
接口描述: 用于获取配额管理主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
QuotaYMDY配额日期(QuotaYMD )。格式为yyyy-MM-dd,这个参数意在查询某月配额数据,所以时间请使用需要查询月份的第一天,如 2024-05-01
QuotaChannelY按渠道查询,多个查询条件可以用逗号(,)分割
BRANDN按品牌可选查询,多个查询条件可以用逗号(,)分割
DETERMINECODEN按物料确定号可选道查询,多个查询条件可以用逗号(,)分割

接口请求示例:
/master/quota?pageSize=20&pageNo=10&BRAND=41&QuotaYMD=2024-01-01&QuotaChannel=202

返回参数

字段类型长度字段描述数据举例
QuotaChannelVARCHAR3渠道
202: POS(百货店POS)
2A2: CN_CHAIN STORE
2A3: CN_DISTRIBUTOR
2A6: OMS-CN_BRAND.COM(官网)
2A7: OMS-CN_EC_RETAIL_TMALL(天猫)
2A9: OMS-CN_EC_RETAIL_TIKTOK(抖音)
2B0: OMS-CN_EC_RETAIL_OTHERS
2B1: CN_EC_WHOLES_TMALL
2B2: CN_EC_WHOLES_JD
2B3: CN_EC_WHOLES_TIKTOK
2B4: CN_EC_WHOLES_OTHERS
2B9: OUTLETS
2C0: CN_AIRPORT STORE
2C6: CN_BEAUTY STORE
2C7: CN_PHARMACY
206
BRANDchar2品牌41
DETERMINECODEVARCHAR13物料确定号74253430801
InitialQuotaINT初始配额100
UpdateInitialQuotaINT人工修正后配额100
QuotaINT配额100
UPDATEMANVARCHAR20更新人EAI
UPDATETIMEdatetime8模板上传数据更新时间2024-06-03 12:11:34.000
CREATEMANVARCHAR20创建人EAI
CREATETIMEdatetime8创建时间2024-06-03 12:11:34.000
EAI_UPDATETIMEdatetimeEAI计算更新时间2024-06-04 15:00:00.000
QuotaYMDdatetime配额日期2023-01-01 00:00:00.000

接口返回值示例

[
    {
        "QuotaChannel": "202",
        "BRAND": "46",
        "DETERMINECODE": "34502473101CN",
        "InitialQuota": null,
        "UpdateInitialQuota": 1000,
        "Quota": 943,
        "UPDATEMAN": "Excel导入",
        "UPDATETIME": "2024-07-15T11:55:04",
        "CREATEMAN": "Excel导入",
        "CREATETIME": "2024-07-15T11:05:06",
        "EAI_UPDATETIME": "2024-07-29T14:00:59.703",
        "QuotaYMD": "2024-07-01T00:00:00"
    },
    {
        "QuotaChannel": "202",
        "BRAND": "46",
        "DETERMINECODE": "34503753101CN",
        "InitialQuota": null,
        "UpdateInitialQuota": 300,
        "Quota": 3,
        "UPDATEMAN": "30010301",
        "UPDATETIME": "2024-07-18T10:20:07",
        "CREATEMAN": "Excel导入",
        "CREATETIME": "2024-07-15T11:05:07",
        "EAI_UPDATETIME": "2024-07-19T17:23:29.753",
        "QuotaYMD": "2024-06-01T00:00:00"
    }
]

3.6 获取配额计算主数据

请求接口: /master/quotaCalculate
接口描述: 用于获取配额计算主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN更新时间(UPDATETIME )最后更新时间,接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00
APPLYYMDY按配额日期查询,格式yyyy-MM-dd,如 2024-05-01,筛选这个日期(包括)之后的数据
QuotaChannelY按渠道查询
APPLYNON按单据编号可选查询
STATUSN按单据状态可选查询
TemplateFlgN按模板上传标识可选查询

接口请求示例:
/master/quotaCalculate?pageSize=20&pageNo=10&APPLYYMD=2024-01-01&QuotaChannel=206

返回参数

字段类型长度字段描述数据举例(正常扣减Sample)数据举例(仅EAI用反向计算Sample)
ID自增列主键5859
APPLYNOchar35单据编号RC0016339129RC0016339129
BusinessTypeVARCHAR3业务类型
10-订货 减少配额
11-退仓 增加配额
99-模板导入
1111
APPLYYMDdatetime配额日期。用于匹配配额月份 yyyy-mm-dd,取当前月(配额计算时当前月份),出库的配额日期以申请日期所在月份扣减配额2023-01-162023-01-16
QuotaChannelVARCHAR3渠道
202:POS(百货店POS)
203:E-order(屈臣氏)
204:CS POS(隐藏)
205:SCHD(代理商)
206:Others(隐藏)
2A6:OMS-CN_BRAND.COM(官网)
2A7:OMS-CN_EC_RETAIL_TMALL(天猫)
2A9:OMS-CN_EC_RETAIL_TIKTOK(抖音)
2B0:OMS-CN_EC_RETAIL_OTHERS
2B9:OUTLETS(奥莱)
206206
BRANDchar2品牌1414
SAP_CUSTOMERCDVARCHAR10SAP Shipto代码22000034342200003434
DETERMINECODEchar13物料确定号7425343080174253430801
ActualQNTYINT实际分配配额数量
推送SAP的数量,也是参与计算的数量
100-100
STATUSchar1单据状态
1-订货
2-出库
3-POD
7-模板导入
8-反向计算(查询履历作为过滤使用)
9-配额不足起订量
18
NOTEVARCHAR500备注。用于描述场景配额不足,分配全部剩余配额退回ID:【58】配额扣除
UPDATETIMEdatetime8更新时间2024-06-04 11:08:19.3872024-06-04 11:08:51.720
TemplateFlgchar1模板上传标识
1-模板上传
0-单据计算
00

接口返回值示例

等待补充

3.7 获取工厂级在库库存

请求接口: /master/stockOnHandPlant
接口描述: 用于获取工厂级在库库存
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN更新时间(UPDATETIME )最后更新时间,接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00
SAP_PLANTY按工厂查询
FineFlgN可按库位代码查询
SAPPRODUCTCDN可按SAP产品代码查询,多个查询条件可以用逗号(,)分割

接口请求示例:
/master/stockOnHandPlant?pageSize=20&pageNo=10&SAP_PLANT=7857&FineFlg=W001

返回参数

字段类型长度字段描述数据举例
SAP_PLANTCHAR4工厂7857
FineFlgCHAR4库位代码W001
SAPPRODUCTCDCHAR40SAP产品代码10100011000CN
CHARGCHAR10批次号2502
BatchENDYMDDATETIME批次到期日20250201
MEINSNVARCHAR3物料基本单位EA
CLABSINT非限制库存261
MaterialTypeCHAR4SAP物料类型Z002
STATUSCHAR16库存状态Unrestricted
ATPBTINT可用库存243
UPDATETIMEDATETIME更新时间2024-06-04 11:08:19.387
PRODUCTCDCHAR10物料代码10100011
DETERMINECODECHAR13物料确定号。10100011000CN

接口返回值示例

[
    {
        "SAP_PLANT": "7857",
        "FineFlg": "W002",
        "SAPPRODUCTCD": "89847500105CN                           ",
        "CHARG": "2503      ",
        "BatchENDYMD": "2025-03-01T00:00:00",
        "MEINS": "EA",
        "CLABS": 1,
        "MaterialType": "Z002",
        "STATUS": "Unrestricted    ",
        "ATPBT": 1,
        "UPDATETIME": "2024-07-29T00:06:58.973",
        "PRODUCTCD": "89847500  ",
        "DETERMINECODE": "89847500105CN"
    },
    {
        "SAP_PLANT": "7857",
        "FineFlg": "W002",
        "SAPPRODUCTCD": "89847500105CN                           ",
        "CHARG": "2341I     ",
        "BatchENDYMD": "2025-12-07T00:00:00",
        "MEINS": "EA",
        "CLABS": 1,
        "MaterialType": "Z002",
        "STATUS": "Unrestricted    ",
        "ATPBT": 1,
        "UPDATETIME": "2024-07-29T00:06:58.953",
        "PRODUCTCD": "89847500  ",
        "DETERMINECODE": "89847500105CN"
    }
]

3.8 获取产品单价主数据

请求接口: /master/productPrice
接口描述: 用于产品单价
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
updateTimeN更新时间(UPDATETIME )最后更新时间,接口筛选此时间之后(包括此时间)更新的数据。格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00
STARTYMDN可按销售开始日查询
SAPPRODUCTCDN可按SAP产品代码查询

接口请求示例:
/master/productPrice?pageSize=20&pageNo=10&updateTime=2024-05-01&SAPPRODUCTCD=10121965801CN

返回参数

字段类型长度字段描述数据举例
SAPPRODUCTCDSAP产品代码CHAR1310121965801CN
STARTYMD销售开始日DATETIME20240501
RPRICEMNY零售单价MONEY2300.0000
UPDATETIME更新时间DATETIME2024-06-04 11:08:19.387

接口返回值示例

[
    {
        "SAPPRODUCTCD": "300007010    ",
        "STARTYMD": "2024-07-16T00:00:00",
        "RPRICEMNY": 3880,
        "UPDATETIME": "2024-07-15T23:00:17.69"
    }
]

3.9 获取SAP入库指示主数据

请求接口: /master/inboundDelivery
接口描述: 用于查询SAP入库指示
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
InStcNoN入库编号/交货单号
SAPPRODUCTCDN物料号
APPLYNON周边POS订单号
TimestampN数据更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/inboundDelivery?pageSize=20&pageNo=10&Timestamp=2024-05-01&APPLYNO=10121965801CN

返回参数

字段类型长度字段描述数据举例
DocumentIDVARCHAR60单据唯一标识d1634210-53d4-11ef-b739-36ac293352b8
InStcNoVARCHAR10入库编号/交货单号4101636671
AUARTVARCHAR4订单类型Z4EL
AdmYMDdatetime交货日期2024-08-05 00:00:00.000
SAP_VENDORCODEVARCHAR10供应商代码0A78500010
SAP_VENDORNAMEVARCHAR80供应商名称Itochu main DC
SAP_COUNTRYVARCHAR3国家CN
BOLNRVARCHAR35提货单NULL
InvoiceNoVARCHAR35发货单编号(发票单号)4500220182
COSNRVARCHAR6内向交货单的行号900003
SAPPRODUCTCDVARCHAR18物料号34502800101CN
DESCRIBEVARCHAR80物料描述AG LIQD BLUSH BEHAVE
CHARGVARCHAR10批次号3226AC
PLACECDVARCHAR4入库场所编号785B
LGORTVARCHAR4库位代码W001
InQntyINT数量30
VRKMEVARCHAR3基本单位EA
BELNRVARCHAR10采购订单号4550135122
VGPOSVARCHAR6采购订单项目号000020
HIPOSVARCHAR6上级项目号000020
PLACECD_FRVARCHAR70出库场所描述7857 Itochu Logistics
LocationIDVARCHAR42出库Storage Location描述W001 良品仓Main Location
BWARTVARCHAR3移动类型101
APPLYNOVARCHAR35周边POS订单号MV220000451920240800013
APPLYNO_SOVARCHAR12SAP的SO单号4101636612
ShiptoMemoInVARCHAR17785B备注特殊Ship-to2200004519
ShiptoMemoOutVARCHAR17785B备注特殊Ship-to2200004519
Timestampdatetime时间戳(当前时间)2024-08-06 17:18:22.000

接口返回值示例

[
    {
        "DocumentID": "7b777b80-64de-11ef-99e0-2a9785477593",
        "InStcNo": "4101637150",
        "AUART": "Z4EL",
        "AdmYMD": "2024-08-28T00:00:00",
        "SAP_VENDORCODE": "0A78500010",
        "SAP_VENDORNAME": "Itochu main DC",
        "SAP_COUNTRY": "CN",
        "BOLNR": null,
        "InvoiceNo": "4500220653",
        "COSNR": "000010",
        "SAPPRODUCTCD": "10217284803CN",
        "DESCRIBE": "UTM P I CONCENTRATE 3 50ML",
        "CHARG": "3132Q",
        "PLACECD": "785J",
        "LGORT": "W001",
        "InQnty": 6,
        "VRKME": "EA",
        "BELNR": "4550135230",
        "VGPOS": "000010",
        "HIPOS": null,
        "PLACECD_FR": "7857 Itochu Logistics",
        "LocationID": "W001 良品仓Main Location",
        "BWART": "101",
        "APPLYNO": "RC-000024-001",
        "APPLYNO_SO": "4101637142",
        "ShiptoMemoIn": "2200003124",
        "ShiptoMemoOut": "2200003124",
        "Timestamp": "2024-08-28T09:40:19"
    },
    {
        "DocumentID": "7b777b80-64de-11ef-99e0-2a9785477593",
        "InStcNo": "4101637150",
        "AUART": "Z4EL",
        "AdmYMD": "2024-08-28T00:00:00",
        "SAP_VENDORCODE": "0A78500010",
        "SAP_VENDORNAME": "Itochu main DC",
        "SAP_COUNTRY": "CN",
        "BOLNR": null,
        "InvoiceNo": "4500220653",
        "COSNR": "000020",
        "SAPPRODUCTCD": "10217284803CN",
        "DESCRIBE": "UTM P I CONCENTRATE 3 50ML",
        "CHARG": "3132R",
        "PLACECD": "785J",
        "LGORT": "W001",
        "InQnty": 5,
        "VRKME": "EA",
        "BELNR": "4550135230",
        "VGPOS": "000020",
        "HIPOS": null,
        "PLACECD_FR": "7857 Itochu Logistics",
        "LocationID": "W001 良品仓Main Location",
        "BWART": "101",
        "APPLYNO": "RC-000024-001",
        "APPLYNO_SO": "4101637142",
        "ShiptoMemoIn": "2200003124",
        "ShiptoMemoOut": "2200003124",
        "Timestamp": "2024-08-28T09:40:19"
    }
]

3.10 获取店铺虚拟套装等其他物料主数据

请求接口: /master/materialSuitMain
接口描述: 用于查询店铺虚拟套装等其他物料
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
OwnerIdN品牌编号
GoodsCodeN商品编号
UpdateDateN数据更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/materialSuitMain?pageSize=20&pageNo=10&UpdateDate=2024-05-01&OwnerId=10121965801CN

返回参数

字段字段描述类型长度数据举例
OwnerId品牌编号varchar411
GoodsCode商品编号varchar20COP00020
GoodsName商品名称(中文)varchar100镭射瓶复购券
BrandId品牌varchar1011
BRANDNM品牌名称CHAR80CLE DE PEAU BEAUTE
LineIdLinevarchar101107
LINENM新品牌名称CHAR80CLE DE PEAU BEAUTE
SublineIdSubLinevarchar100710
SUBLINENM新产品系列名称CHAR80CPB
BEAMTDCD1美容法1varchar1090
BEAMTDCD2美容法2varchar109090
BEAMTDCD3美容法3varchar10909090
SalePrice销售单价decimal(12,4)155.0000
EffectiveDate生效日期Datetime2019-12-04 11:26:28.000
GoodsSubTypePOS商品子区分varchar26
IsIncludeProdNumcd套装是否含有号组int0
DelFlg删除标记varchar10
UpdateDate更新时间Datetime2023-01-03 17:25:43.000
SourceDec来源描述varchar10POS

接口返回值示例

[
    {
        "OwnerId": "10",
        "GoodsCode": "COP00203",
        "GoodsName": "抽奖加赠礼-NARS黑色羽绒化妆包",
        "BrandId": "10",
        "BRANDNM": null,
        "LineId": "1070",
        "LINENM": null,
        "SublineId": "7005",
        "SUBLINENM": null,
        "BEAMTDCD1": "90",
        "BEAMTDCD2": "9090",
        "BEAMTDCD3": "909090",
        "SalePrice": 0,
        "EffectiveDate": "2024-08-15T19:01:04",
        "GoodsSubType": "6",
        "IsIncludeProdNumcd": "0",
        "DelFlg": "0",
        "UpdateDate": "2024-08-15T19:01:04",
        "SourceDec": "POS"
    },
    {
        "OwnerId": "10",
        "GoodsCode": "COP00202",
        "GoodsName": "抽奖加赠礼-NARS红色帆布袋",
        "BrandId": "10",
        "BRANDNM": null,
        "LineId": "1070",
        "LINENM": null,
        "SublineId": "7005",
        "SUBLINENM": null,
        "BEAMTDCD1": "90",
        "BEAMTDCD2": "9090",
        "BEAMTDCD3": "909090",
        "SalePrice": 0,
        "EffectiveDate": "2024-08-15T19:00:36",
        "GoodsSubType": "6",
        "IsIncludeProdNumcd": "0",
        "DelFlg": "0",
        "UpdateDate": "2024-08-15T19:00:36",
        "SourceDec": "POS"
    }
]

3.11 获取店铺虚拟套装明细主数据

请求接口: /master/materialSuitSub
接口描述: 用于查询店铺虚拟套装明细
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
OwnerIdN品牌编号
GoodsCodeN商品编号
UpdateDateN数据更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/materialSuitSub?pageSize=20&pageNo=10&UpdateDate=2024-05-01&OwnerId=10121965801CN

返回参数

字段字段描述类型长度数据举例
OwnerId品牌编号varchar410
GoodsCode套装商品编号varchar20GP100001
DetailGoodsCode明细商品编号/号组编号varchar2010101340
Qty所含当前明细商品数量int1
IsProdNumcd是否号组int0
UpdateDate更新时间Datetime2019-10-29 12:00:29.000

接口返回值示例

[
    {
        "OwnerId": "41",
        "GoodsCode": "SP410230",
        "DetailGoodsCode": "113544",
        "Qty": 2,
        "IsProdNumcd": "0",
        "UpdateDate": "2024-06-05T18:19:51"
    },
    {
        "OwnerId": "10",
        "GoodsCode": "GP103031",
        "DetailGoodsCode": "1015B832",
        "Qty": 1,
        "IsProdNumcd": "0",
        "UpdateDate": "2024-05-29T15:58:36"
    },
    {
        "OwnerId": "10",
        "GoodsCode": "GP103030",
        "DetailGoodsCode": "10000E",
        "Qty": 1,
        "IsProdNumcd": "0",
        "UpdateDate": "2024-05-29T15:49:25"
    }
]

3.12 获取客户主数据(fro业务)主数据

请求接口: /master/businessCustomer
接口描述: 用于查询客户主数据(fro业务)主数据
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
CUSTOMERCDN周边商店代码
SUBUNITCDN所属办事处代码
SUBOFFICEN二级办事处
CustomerBrandN商店所属品牌
JYFLGN解约区分
SALEPATNN客户分类
SAP_CUSTOMERCDNShipTo代码
MDMUPDATETIMEN数据更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/businessCustomer?pageSize=20&pageNo=10&MDMUPDATETIME=2024-05-01&SAP_CUSTOMERCD=1012

返回参数

字段类型长度字段描述数据举例
COMPANYCDchar4所属公司代码785
CUSTOMERCDchar60周边商店代码10100313
SUBUNITCDchar3所属办事处代码101
SUBUNITNMchar40所属办事处名SHI办事处
SUBOFFICEchar5二级办事处00003
SUBOFFICENMchar40二级办事处名天津
SIDECDchar3省代码002
SIDENMchar40天津市
AREACDchar3市代码003
AREANMchar40天津
CUSTOMERNMchar280Shipto名称SHI天津海信-上海梧颜直发
CUSTRANKchar1店级别K1
TRASTAYMDdatetime合作开始日2022-10-20 00:00:00.000
ENDYMDdatetime终了日期2022-12-31 00:00:00.000
CustomerBrandchar18商店所属品牌10
CUSTOMERBRANDNMchar40商店所属品牌名称SHISEIDO
MDMUPDATETIMEdatetime更新时间2023-07-18 10:03:02.530
CUSTOMERNMJvarchar80商店简称NULL
Longitudechar15经度NULL
Latitudechar15纬度NULL
SAP_CHANNELTYPEchar3SAP渠道类型52
SAP_CHANNELTYPEENNMchar80SAP渠道类型名称Department store (Wholesale) (SCH, SHK only)
JYFLGchar1解约区分1
LOCALCHANNELCD1char1现地渠道类型1代码1
Industrychar2门店渠道 (for CMI 报表)1
IndustryNMvarchar11门店渠道名称FSS
SALEPATNchar2客户分类K1
TOKUISAKICDchar8百货集团代码0001
STOREGROUPNMchar60百货集团名称百联
UNITCUSTOMERCDchar10统合店铺代码12dps01663
ExCUSTOMERCDchar10外部店代码
SAP_CUSTOMERCDchar10ShipTo代码10100313
SHOPSIGNNMchar60店招名SHI天津海信-上海梧颜直发
SHOPADRchar80店地址天津市和平区解放北路188号海信广场一楼资生堂专柜
SOLDTOchar10Soldto代码2100006705
SOLDTONMchar280Soldto名称湖北仙桃银泰百货有限公司
SHOPTELCHAR30店铺电话13800000000

接口返回值示例

[
  {
    "COMPANYCD": "785 ",
    "CUSTOMERCD": "0A86600004                                                  ",
    "SUBUNITCD": null,
    "SUBUNITNM": null,
    "SUBOFFICE": null,
    "SUBOFFICENM": null,
    "SIDECD": null,
    "SIDENM": null,
    "AREACD": "905",
    "AREANM": "Singapore           ",
    "CUSTOMERNM": "Shiseido Singapore Co. (Pte.) Ltd.Bollore Logistics Singapore",
    "CUSTRANK": null,
    "TRASTAYMD": null,
    "ENDYMD": null,
    "CustomerBrand": null,
    "CUSTOMERBRANDNM": null,
    "MDMUPDATETIME": "2024-09-06T01:10:33.683",
    "CUSTOMERNMJ": null,
    "Longitude": null,
    "Latitude": null,
    "SAP_CHANNELTYPE": "L1 ",
    "SAP_CHANNELTYPEENNM": "Shiseido Group Companies                                                        ",
    "JYFLG": "0",
    "LOCALCHANNELCD1": null,
    "Industry": null,
    "IndustryNM": null,
    "SALEPATN": null,
    "TOKUISAKICD": null,
    "STOREGROUPNM": null,
    "UNITCUSTOMERCD": null,
    "ExCUSTOMERCD": null,
    "SAP_CUSTOMERCD": "0A86600004",
    "SHOPSIGNNM": "Shiseido Singapore Co. (Pte.) Ltd.Bollore Logistics Singapor",
    "SHOPADR": null,
    "SHOPTEL": "13800000000"
  }
]

3.13 店铺人员人店关系主数据

请求接口: /master/cusEmployeeMapping
接口描述: 用于查询店铺人员人店关系
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
EmployeeIdN员工工号
UpdateDateN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/cusEmployeeMapping?pageSize=20&pageNo=10&UpdateDate=2024-05-01&EmployeeId=1012

返回参数

字段字段描述类型长度数据举例
OwnerId品牌编号varchar411
EmployeeId员工工号varchar1000007789
StoreId所属店铺varchar1000300063
EmployeeType员工分类varchar405
UpdateDate更新时间Datetime2024-08-20 08:00:33.000
AgentManager是否代理店长int0
ddposition担当职务varchar20

接口返回值示例

[
  {
    "OwnerId": "11",
    "EmployeeId": "30015031",
    "StoreId": null,
    "EmployeeType": "03",
    "UpdateDate": "2024-09-12T08:00:18",
    "AgentManager": "0"
  },
  {
    "OwnerId": "11",
    "EmployeeId": "30016204",
    "StoreId": null,
    "EmployeeType": "03",
    "UpdateDate": "2024-09-12T08:00:18",
    "AgentManager": "0"
  },
  {
    "OwnerId": "11",
    "EmployeeId": "30016804",
    "StoreId": null,
    "EmployeeType": "03",
    "UpdateDate": "2024-09-12T08:00:18",
    "AgentManager": "0"
  }
]

3.14 总部人员销售角色主数据

请求接口: /master/empstruct
接口描述: 用于查询总部人员销售角色
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
BRANDCDN品牌
EMPCODEN员工代码
REGIONCODEN区域代码
REGION_LEVELN区域级别
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/empstruct?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&BRANDCD=1012

返回参数

字段字段描述类型长度数据举例
BRANDCD品牌CHAR210
BRANDNM品牌名称CHAR80SHISEIDO
EMPCODE员工代码CHAR8000000529
REGIONCODE区域代码CHAR10001
REGION_LEVEL区域级别CHAR11
EMPROLECD角色代码CHAR3001
EMPROLENM角色名称CHAR40SM
UPDATETIME更新时间DATETIME2022-02-14 14:17:34.820

接口返回值示例

[
  {
    "BRANDCD": "10",
    "BRANDNM": "SHISEIDO                                ",
    "EMPCODE": "QT007827",
    "REGIONCODE": "00005     ",
    "REGION_LEVEL": "3",
    "EMPROLECD": "002",
    "EMPROLENM": "AM                                      ",
    "UPDATETIME": "2024-09-09T13:37:52"
  },
  {
    "BRANDCD": "41",
    "BRANDNM": "IPSA                                    ",
    "EMPCODE": "30011331",
    "REGIONCODE": "10300047  ",
    "REGION_LEVEL": "4",
    "EMPROLECD": "004",
    "EMPROLENM": "SS                                      ",
    "UPDATETIME": "2023-08-21T16:01:46"
  }
]

3.15 品牌地区架构主数据

请求接口: /master/structMaster
接口描述: 用于查询品牌地区架构
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
BRANDCDN品牌
AREABUNON营业部代码
REGIONCODEN区域代码
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/structMaster?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&BRANDCD=1012

返回参数

字段字段描述类型长度数据举例
BRANDCD品牌Varchar210
BRANDNM品牌名称Varchar80SHISEIDO
AREABUNO营业部代码Varchar3001
AREABUNAME营业部名称Varchar50SHI一区
REGIONCODE区域代码Varchar1000007
REGIONNAME区域名称Varchar40黑龙江
UPDATETIME更新时间DATETIME2024-01-30 18:23:23.390

接口返回值示例

[
  {
    "BRANDCD": "10",
    "BRANDNM": "SHISEIDO",
    "AREABUNO": "002",
    "AREABUNAME": "SHI二区",
    "REGIONCODE": "00001   ",
    "REGIONNAME": "北京A                                   ",
    "UPDATETIME": "2023-11-09T19:32:33.607"
  },
  {
    "BRANDCD": "41",
    "BRANDNM": null,
    "AREABUNO": "039",
    "AREABUNAME": null,
    "REGIONCODE": "00040   ",
    "REGIONNAME": "EC                                      ",
    "UPDATETIME": "2023-10-02T17:56:24.727"
  }
]

3.16 实物组套主件子件关系

请求接口: /master/materialSuitInfo
接口描述: 用于查询实物组套主件子件关系
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
brandN品牌
set_typeN套装类型
material_typeN套装物料类型
material_numberN套装产品编码
sub_material_numberN子件产品编号
sub_material_typeN子件物料类型
update_dateN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/materialSuitInfo?pageSize=20&pageNo=10&update_date=2024-05-01&brand=1012

返回参数

字段字段描述类型长度数据举例
brand品牌nvarchar2011
BRANDNM品牌名称CHAR80CLE DE PEAU BEAUTE
set_type套装类型01
material_type套装物料类型nvarchar10Z001
material_number套装产品编码nvarchar2010179057803
suit_name套装名称nvarchar100LocalZ001单个组套非计划1
sub_cost_price套装零售价格numeric20,20.00
sub_material_number子件产品编号nvarchar10010179059801
DETERMINECODE物料确定号CHAR1310179059801
sub_material_name子件产品名nvarchar100洗颜专科 凝润深透 保湿柔肤露(清爽型)
sub_material_type子件物料类型nvarchar20Z001
sub_quantity子件数量numeric20,26.00
is_give是否赠送nvarchar201
apply_user_cd申请人cdnvarchar5000002049
update_date更新时间datetime272023-10-27 17:25:34.8300000

接口返回值示例

[
  {
    "brand": "11",
    "BRANDNM": "CLE DE PEAU BEAUTE                                                              ",
    "set_type": "01",
    "material_type": "Z002",
    "material_number": "10100317000CN",
    "suit_name": "CPB 光采赋活日间防护霜 SS",
    "set_retail_unit_price": 0,
    "sub_material_number": "10100317000CN",
    "DETERMINECODE": "10100317000CN",
    "sub_material_name": "CPB 光采赋活日间防护霜 SS",
    "sub_material_type": "Z002",
    "sub_quantity": 1,
    "is_give": "0",
    "apply_user_cd": "00002049",
    "update_date": "2024-09-03T17:00:11.594"
  },
  {
    "brand": "11",
    "BRANDNM": "CLE DE PEAU BEAUTE                                                              ",
    "set_type": "01",
    "material_type": "Z002",
    "material_number": "10100317000CN",
    "suit_name": "CPB 光采赋活日间防护霜 SS",
    "set_retail_unit_price": 0,
    "sub_material_number": "10100318000CN",
    "DETERMINECODE": "10100318000CN",
    "sub_material_name": "CPB-肌肤之钥 光采赋活夜间修护乳 SS                                                                 ",
    "sub_material_type": "Z002",
    "sub_quantity": 1,
    "is_give": "0",
    "apply_user_cd": "00002049",
    "update_date": "2024-09-03T17:00:11.594"
  }
]

3.17 办事处主表

请求接口: /master/subUnit
接口描述: 用于查询办事处主表
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
SUBUNITCDN办事处代码
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/subUnit?pageSize=20&pageNo=10&update_date=2024-05-01&brand=1012

返回参数

字段字段描述类型长度数据举例
SUBUNITCD办事处代码Varchar3246
SUBUNITNM办事处名称Varchar80PM天津弘方化妆品有限公司
DELFLG删除标志Varchar500
UNITAGENTCD统合代理商代码Varchar6A021
UPDATETIME更新时间datetime2023-06-14 23:00:12.073

接口返回值示例

[
  {
    "SUBUNITCD": "101",
    "SUBUNITNM": "SHI办事处                               ",
    "DELFLG": "0",
    "UNITAGENTCD": null,
    "UPDATETIME": "2023-06-14T23:00:10.92"
  },
  {
    "SUBUNITCD": "102",
    "SUBUNITNM": "CPB办事处                               ",
    "DELFLG": "0",
    "UNITAGENTCD": null,
    "UPDATETIME": "2023-06-14T23:00:11.057"
  }
]

3.18 主数据:现地品牌

请求接口: /master/brand
接口描述: 用于查询现地品牌
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
BRANDCDN现地品牌代码
DELFLGN删除标识
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/brand?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&BRANDCD=1012

返回参数

字段字段描述类型长度数据举例
BRANDCD现地品牌代码Varchar31001
BRANDNM现地品牌名称Varchar40SHI
DELFLG删除标志:0-有效,1-删除char10
UPDATETIME更新时间datetime2023-06-14 23:00:12.073
BRANDENGNM现地品牌英文名称varchar10011

接口返回值示例

[
    {
        "BRANDCD": "1001",
        "BRANDNM": "SHI                 ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-16T10:15:56.287",
        "BRANDENGNM": "11"
    },
    {
        "BRANDCD": "1102",
        "BRANDNM": "Radiance Trio       ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-16T10:15:56.29",
        "BRANDENGNM": null
    },
    {
        "BRANDCD": "1103",
        "BRANDNM": "Supreme             ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-16T10:15:56.29",
        "BRANDENGNM": "11"
    }
]

3.19 主数据:现地美容法1

请求接口: /master/localbeamtd1
接口描述: 用于查询现现地美容法1
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
LOCALBEAMTDCD1N现地美容法1代码
DELFLGN删除标识
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/localbeamtd1?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&LOCALBEAMTDCD1=1

返回参数

字段字段描述类型长度数据举例
LOCALBEAMTDCD1现地美容法1代码Varchar31
LOCALBEAMTDENNM1现地美容法1英文char80Skin Care
LOCALBEAMTDCHINM1现地美容法1中文char80护肤
PRODUCTCODE财务税分类代码char10107022302
DELFLG删除标志:0-有效,1-删除char10
UPDATETIME更新时间datetime82023-06-14 23:00:12.073

接口返回值示例

[
    {
        "LOCALBEAMTDCD1": "2",
        "LOCALBEAMTDENNM1": "Makeup                                                                          ",
        "LOCALBEAMTDCHINM1": "彩妆                                                                            ",
        "PRODUCTCODE": "107022304 ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:40:15.683"
    },
    {
        "LOCALBEAMTDCD1": "3",
        "LOCALBEAMTDENNM1": "Body                                                                            ",
        "LOCALBEAMTDCHINM1": "美体                                                                            ",
        "PRODUCTCODE": "107022302 ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:40:15.687"
    },
    {
        "LOCALBEAMTDCD1": "4",
        "LOCALBEAMTDENNM1": "Hair                                                                            ",
        "LOCALBEAMTDCHINM1": "美发                                                                            ",
        "PRODUCTCODE": "107022303 ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:40:15.687"
    }
]

3.20 主数据:现地美容法2

请求接口: /master/localbeamtd2
接口描述: 用于查询现现地美容法2
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
LOCALBEAMTDCD2N现地美容法2代码
DELFLGN删除标识
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/localbeamtd2?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&LOCALBEAMTDCD2=1

返回参数

字段字段描述类型长度数据举例
LOCALBEAMTDCD2现地美容法2代码Varchar310
LOCALBEAMTDENNM2现地美容法2英文char80Face
LOCALBEAMTDCHINM2现地美容法2中文char80脸部
DELFLG删除标志:0-有效,1-删除char10
UPDATETIME更新时间datetime82023-06-14 23:00:12.073

接口返回值示例

[
    {
        "LOCALBEAMTDCD2": "10",
        "LOCALBEAMTDENNM2": "Face                                                                            ",
        "LOCALBEAMTDCHINM2": "脸部                                                                            ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:46:34.837"
    },
    {
        "LOCALBEAMTDCD2": "20",
        "LOCALBEAMTDENNM2": "Eye                                                                             ",
        "LOCALBEAMTDCHINM2": "眼部                                                                            ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:46:34.84"
    },
    {
        "LOCALBEAMTDCD2": "30",
        "LOCALBEAMTDENNM2": "Lip                                                                             ",
        "LOCALBEAMTDCHINM2": "唇部                                                                            ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:46:34.84"
    },
    {
        "LOCALBEAMTDCD2": "40",
        "LOCALBEAMTDENNM2": "Cheek                                                                           ",
        "LOCALBEAMTDCHINM2": "面颊                                                                            ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T14:46:34.84"
    }
]

3.21 主数据:现地美容法3

请求接口: /master/localbeamtd3
接口描述: 用于查询现现地美容法3
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
LOCALBEAMTDCD1N现地美容法1代码
LOCALBEAMTDCD3N现地美容法3代码
DELFLGN删除标识
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/localbeamtd3?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&LOCALBEAMTDCD1=1

返回参数

字段字段描述类型长度数据举例
LOCALBEAMTDCD1现地美容法1代码Varchar11
LOCALBEAMTDCD3现地美容法3代码Varchar3001
LOCALBEAMTDENNM3现地美容法3英文char80Cleansing Cream
LOCALBEAMTDCHINM3现地美容法3中文char80护肤-洁面
DELFLG删除标志:0-有效,1-删除char10
UPDATETIME更新时间datetime82023-06-14 23:00:12.073

接口返回值示例

[
    {
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD3": "001",
        "LOCALBEAMTDENNM3": "Cleansing Cream                                                                 ",
        "LOCALBEAMTDCHINM3": "护肤-洁面                                                                       ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T15:17:35.353"
    },
    {
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD3": "002",
        "LOCALBEAMTDENNM3": "Cleansing Gel                                                                   ",
        "LOCALBEAMTDCHINM3": "护肤-洁面啫喱                                                                   ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T15:17:35.353"
    },
    {
        "LOCALBEAMTDCD1": "1",
        "LOCALBEAMTDCD3": "003",
        "LOCALBEAMTDENNM3": "Cleansing Soap                                                                  ",
        "LOCALBEAMTDCHINM3": "护肤-洁面皂                                                                     ",
        "DELFLG": "0",
        "UPDATETIME": "2019-05-04T15:17:35.357"
    }
]

3.22 主数据:自定义分类子类别

请求接口: /master/custSubCategory
接口描述: 用于查询自定义分类子类别
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
OwnerIdN品牌
CateIDN分类ID
SubCateIDN子类别ID
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/custSubCategory?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&OwnerId=1

返回参数

字段字段描述类型长度数据举例
OwnerId品牌Varchar414
CateID分类IDVarchar2011
SubCateID子类别IDchar201101
SubCateName子类别名称char40点金霜
UPDATETIME更新时间datetime82023-06-14 23:00:12.073

接口返回值示例

[
    {
        "OwnerId": "14",
        "CateID": "11",
        "SubCateID": "1101",
        "SubCateName": "点金霜",
        "UPDATETIME": "2021-11-18T00:00:00"
    },
    {
        "OwnerId": "14",
        "CateID": "11",
        "SubCateID": "1102",
        "SubCateName": "金腰子",
        "UPDATETIME": "2022-02-14T08:12:11.433"
    }
]

3.23 主数据:产品自定义分类关系表

请求接口: /master/custSubLineCategory
接口描述: 用于查询产品自定义分类关系表
请求类型: HTTP GET

请求参数:

字段名称必填字段描述
pageSizeN按分页获取数据,每页显示数据条目。即分页大小。默认10
pageNoN按分页获取数据,当前页码。分页从0开始(0为初始页)。默认0
OwnerIdN品牌
YearMonthN年月
CateIDN分类ID
SubCateIDN子类别ID
GoodsCodeN商品编码
UPDATETIMEN更新时间,格式为yyyy-MM-dd,如 2024-05-01,也可以是yyyy-MM-dd HH:mm:ss,如 2024-05-01 09:30:00

接口请求示例:
/master/custSubLineCategory?pageSize=20&pageNo=10&UPDATETIME=2024-05-01&OwnerId=1

返回参数

字段字段描述类型长度数据举例
OwnerId品牌Varchar414
YearMonth年月Datetime2022-01-01 00:00:00.000
CateID分类Ichar2011
SubCateID子类别IDchar201101
GoodsCode商品编码char4045604
GoodsName商品名称char40悠莱 生机明眸 金致紧塑眼霜
UPDATETIME更新时间datetime82023-06-14 23:00:12.073

接口返回值示例

[
    {
        "OwnerId": "14",
        "YearMonth": "2022-01-01T00:00:00",
        "CateID": "11",
        "SubCateID": "1101",
        "GoodsCode": "45604",
        "GoodsName": "悠莱 生机明眸 金致紧塑眼霜              ",
        "UPDATETIME": "2022-01-25T12:37:21.61"
    },
    {
        "OwnerId": "14",
        "YearMonth": "2022-01-01T00:00:00",
        "CateID": "11",
        "SubCateID": "1101",
        "GoodsCode": "45699",
        "GoodsName": "悠莱 生机明眸金致紧塑眼霜(新年限定版)   ",
        "UPDATETIME": "2022-01-25T12:37:21.613"
    }
]

Reviews